home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / bbsfind1.zip / WHERE44A.ZIP / WHEREIS.DOC < prev    next >
Text File  |  1990-12-18  |  43KB  |  1,002 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                            WhereIs  Version 4.4a
  10.  
  11.                            Released Dec 18,  1990
  12.  
  13.                      A PC-DOS / MS-DOS Fast File Finder
  14.  
  15.  
  16.  
  17.                               _______
  18.                          ____|__     |               (tm)
  19.                       --|       |    |-------------------
  20.                         |   ____|__  |  Association of
  21.                         |  |       |_|  Shareware
  22.                         |__|   o   |    Professionals
  23.                       -----|   |   |---------------------
  24.                            |___|___|    MEMBER
  25.  
  26.  
  27.  
  28.  
  29.                      Written by Keith Ledbetter
  30.                                 4240 Ketcham Drive
  31.                                 Chesterfield, VA  23832
  32.                                 (804) 674-0780
  33.                                 (6:00pm - 10:00pm Eastern Time)
  34.  
  35.  
  36.                     Electronic mail on GEnie     : ORION.MICRO
  37.                                        CompuServe: 72240,1221
  38.  
  39.  
  40.  
  41.      Program and Documentation are Copyright (c) 1990 by Keith Ledbetter.
  42.                              All rights reserved.
  43.  
  44.  
  45.  Portions Copyright Borland, International.  WhereIs is written in Turbo C++.
  46.  
  47.  
  48.     This program is produced by a member of the Association of Shareware
  49. Professionals (ASP).  ASP wants to make sure that the shareware principle
  50. works for you. If you are unable to resolve a shareware-related problem with
  51. an ASP member by contacting the member directly, ASP may be able to help. The
  52. ASP Ombudsman can help you resolve a dispute or problem with an ASP member,
  53. but does not provide technical support for members' products. Please write to
  54. the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  55. message via easyplex to ASP Ombudsman 70007,3536.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.    WhereIs Registration Form     Keith Ledbetter
  64.                                  4240 Ketcham Drive
  65.                                  Chesterfield, VA  23832
  66.  
  67.  
  68.    WhereIs Version 4.4a                        Quantity    Price
  69.  
  70.    Disk with branding utility ($15/copy):      _______   __________
  71.  
  72.         Total enclosed                                   __________
  73.  
  74.    Please make payment by check or money order (in US funds) payable
  75.    to "Keith Ledbetter".
  76.  
  77.    Please specify the diskette size(s) that are acceptable for you:
  78.  
  79.    ___ 5.25" 1.2MB   ___ 3.5" 1.44MB   ___ 5.25" 360KB   ___ 3.50" 720KB
  80.  
  81.  
  82.    Name    ________________________________________________________
  83.  
  84.    Company ________________________________________________________
  85.  
  86.    Address ________________________________________________________
  87.  
  88.            ________________________________________________________
  89.  
  90.    Phone   ________________________________________________________
  91.  
  92.  
  93.    Where did you get WhereIs?   ____________________________________
  94.  
  95.    Multi-System and Reseller Licenses:
  96.  
  97.         Site, corporate, network, and reseller licenses are available
  98.         for WhereIs.  Check the line on the order form or contact me for
  99.         more information.  The following schedule provides some
  100.         examples of multi-system license fees.  The fee includes one
  101.         master diskette which you may then copy and use on the number
  102.         of machines listed below:
  103.  
  104.                         # Users        Price
  105.                         -------       -------
  106.                            5        $   70.00   ($14 / copy)
  107.                           10           130.00   ($13 / copy)
  108.                           25           300.00   ($12 / copy)
  109.                           50           550.00   ($11 / copy)
  110.                          100         1,000.00   ($10 / copy)
  111.                        Unlimited     1,500.00
  112.  
  113.                                  WhereIs v4.4a                        Page 1
  114.  
  115.  
  116.                             Definition of ShareWare                           
  117.  
  118.  
  119.  
  120.     Shareware distribution gives users a chance to try software before
  121.     buying it.  If you try a Shareware program and continue using it,
  122.     you are expected to register. Individual programs differ on details
  123.     -- some request registration while others require it, some specify
  124.     a maximum trial period. With registration, you get anything from the
  125.     simple right to continue using the software to an updated program with
  126.     printed manual.
  127.  
  128.     Copyright laws apply to both Shareware and commercial software,
  129.     and the copyright holder retains all rights, with a few specific
  130.     exceptions as stated below. Shareware authors are accomplished
  131.     programmers, just like commercial authors, and the programs are
  132.     of comparable quality. (In both cases, there are good programs
  133.     and bad ones!) The main difference is in the method of
  134.     distribution. The author specifically grants the right to copy
  135.     and distribute the software, either to all and sundry or to a
  136.     specific group. For example, some authors require written
  137.     permission before a commercial disk vendor may copy their
  138.     Shareware.
  139.  
  140.     Shareware is a distribution method, not a type of software. You
  141.     should find software that suits your needs and pocketbook,
  142.     whether it's commercial or Shareware. The Shareware system makes
  143.     fitting your needs easier, because you can try before you buy.
  144.     And because the overhead is low, prices are low also. Shareware
  145.     has the ultimate money-back guarantee -- if you don't use the
  146.     product, you don't pay for it.
  147.  
  148.                                  WhereIs v4.4a                        Page 2
  149.  
  150.  
  151.                              Disclaimer - Agreement                           
  152.  
  153.  
  154.  
  155.     Users of WhereIs must accept this disclaimer of warranty:
  156.     "WhereIs is supplied as is.  The author disclaims all
  157.     warranties, expressed or implied, including, without limitation,
  158.     the warranties of merchantability and of fitness for any purpose.
  159.     The author assumes no liability for damages, direct or conse-
  160.     quential, which may result from the use of WhereIs."
  161.  
  162.     WhereIs is a "shareware program" and is provided at no charge
  163.     to the user for evaluation.  Feel free to share it with your
  164.     friends, but please do not give it away altered or as part of
  165.     another system.  The essence of "user-supported" software is to
  166.     provide personal computer users with quality software without
  167.     high prices, and yet to provide incentive for programmers to
  168.     continue to develop new products.  If you find this program
  169.     useful and find that you are using WhereIs and continue to use
  170.     WhereIs after a reasonable trial period, you must make a reg-
  171.     istration payment of $15 to Keith Ledbetter.  The $15
  172.     registration fee will license one copy for use on any one
  173.     computer at any one time.  You must treat this software just like
  174.     a book.  An example is that this software may be used by any
  175.     number of people and may be freely moved from one computer
  176.     location to another, so long as there is no possibility of it
  177.     being used at one location while it's being used at another.
  178.     Just as a book cannot be read by two different persons at the
  179.     same time.
  180.  
  181.     Commercial users of WhereIs must register and pay for their
  182.     copies of WhereIs within 30 days of first use or their license
  183.     is withdrawn.  Site-License arrangements may be made by con-
  184.     tacting Keith Ledbetter.
  185.  
  186.     Anyone distributing WhereIs for any kind of remuneration must
  187.     first contact Keith Ledbetter at the address below for authorization.
  188.     This authorization will be automatically granted to distributors
  189.     recognized by the (ASP) as adhering to its guidelines for
  190.     shareware distributors, and such distributors may begin offering
  191.     WhereIs immediately (However Keith Ledbetter must still be advised so
  192.     that the distributor can be kept up-to-date with the latest
  193.     version of WhereIs).
  194.  
  195.     You are encouraged to pass a copy of WhereIs along to your
  196.     friends for evaluation.  Please encourage them to register their
  197.     copy if they find that they can use it.  All registered users
  198.     will receive a copy of the latest version of the WhereIs
  199.     system.
  200.  
  201.                                  WhereIs v4.4a                        Page 3
  202.  
  203.  
  204.                                   Introduction                                
  205.  
  206.  
  207.  
  208. Note:  For a list of new features in this version, see the file HISTORY.DOC.
  209.  
  210.  
  211.    Thank you for taking the time to try out WhereIs v4.4a.  You will find
  212. that WhereIs can satisfy almost all of your file searching needs.  It has
  213. a multitude of search options, some of which are:
  214.  
  215.             o   The ability to search inside ARC, ZIP, PKA, PAK,
  216.                 ZOO, and LZH archived files.
  217.  
  218.             o   The ability to search for files that have been
  219.                 compressed with PK-Ware's PKLite program.
  220.  
  221.             o   True regular expression searching on filenames.
  222.  
  223.             o   The ability to display duplicate entries across all of
  224.                 your disk drives (even those duplicates that are in the
  225.                 archive files mentioned above!).
  226.  
  227.             o   Up to 25 filenames can be excluded from the search.
  228.  
  229.             o   Built-in ZIP archive error detection.  Every time you
  230.                 do a search that includes ZIP files, every ZIP file on
  231.                 your hard drive is checked for integrity!
  232.  
  233.             o   The ability to do restrictive searches on such criteria
  234.                 as file dates and file sizes.
  235.  
  236.             o   The ability to do a verified (or un-verified) deletion
  237.                 of any files found in the search (great for periodically
  238.                 deleting those .BAK files or files with a size of zero).
  239.  
  240.             o   Support for Novell's "volume" configurations.
  241.  
  242.             o   Default switches can be set in an environment variable.
  243.  
  244.  
  245.    Don't be fooled by imitations.  There are recent file finder programs out
  246. there making claims that their "features" are "never before found in any
  247. file finder programs".   Funny!  Their "features" (like date-range searching
  248. and filesize searching) have been in our program a YEAR before they were
  249. even released!
  250.  
  251.  
  252.    Now, here is the only pitch that you'll see in this document for some of
  253. your hard-earned money.   WhereIs is being distributed as a Shareware
  254. product.   If you find that you are still using this program a couple of
  255. weeks after you get it, please take the time to fill out the registration
  256. form at the front of this documentation file and send in your registration
  257. fee of $15.
  258.  
  259.  
  260.                                  WhereIs v4.4a                        Page 4
  261.  
  262.  
  263.                                   Introduction                                
  264.  
  265.  
  266.  
  267.    When you send in your registration fee, you will receive a disk with the
  268. most recent version of WhereIs, along with a BRAND utility that you can use
  269. to place your name and serial number into ALL FUTURE VERSION of WhereIs.
  270. No future upgrade costs; you pay only one time!   You will also receive
  271. unlimited telephone support for the program.   Registered WhereIs users may
  272. call me at (804) 674-0780 between the hours of 6:00 pm - 10:00 pm (Eastern)
  273. Monday-Friday, and from 10 am - 6 pm on the weekends.   Thank you for
  274. supporting WhereIs and my other Shareware programs!
  275.  
  276.  
  277.                                  WhereIs v4.4a                        Page 5
  278.  
  279.  
  280.                                What WhereIs Does                              
  281.  
  282.  
  283.  
  284.   WhereIs helps hard drive owners retain (some of) their sanity by locating
  285. files on their hard drives.   We've all had situations where we KNOW that a
  286. file is somewhere on the hard drive; we just can't remember where.  Another
  287. added feature of WhereIs is that it can be told to look inside of ARC files,
  288. too.  This is a very important feature with the common acceptance of archived
  289. files these days.  In this document, "ARC files" is used as a generic term
  290. for any file with the following extension:
  291.  
  292.                 .ARC    .ZIP    .LZH    .ZOO    .PAK    .PKA
  293.  
  294.   Other advanced features of WhereIs include (a) grep-type searching on
  295. filenames (ie: find filenames with a '4' in the fifth character), (b) date
  296. and time range specifiers, and (c) file size range specifiers.  There are
  297. many switches for WhereIs, and it is highly recommended that you read this
  298. document carefully so that you will be able to get the most out of the
  299. program.  There are very few things you can't do with WhereIs when it comes
  300. to locating files.   As an advanced example:
  301.  
  302.  
  303.     whereis cde:*.bak "[0-9]" -gt1024 -lt2048 -s12-10-89 -b12-20-89 -v
  304.  
  305.  
  306.    How about THAT for a command line?  What this would do is delete all .BAK
  307. files on drives C:, D:, and E: that have a number somewhere in the filename
  308. (ie: PROG01.BAK).  But, only if the file is between 1025 and 2047 bytes in
  309. length, and was last modified sometime between the dates of 12-10-89 and
  310. 12-19-89.
  311.  
  312.    Yes, I know that you'll probably never need to do something exotic as
  313. this, but it shows the power that you have with WhereIs.  Take the time to
  314. learn WhereIs, and it will always be your friend (sounds like Mr. Rogers!).
  315.  
  316.                                  WhereIs v4.4a                        Page 6
  317.  
  318.  
  319.                            The Command Line Interface                         
  320.  
  321.  
  322.  
  323.   Invoking WhereIs is simplicity itself.  If you do not specify a path,
  324. then WhereIs will search the entire default drive.  If you specify a
  325. starting path, then the search will occur from that path downward (only).
  326.  
  327.   Here are some basic command line examples:
  328.  
  329.   whereis ab*.c                 search entire default drive for any filename
  330.                                 matching "ab*.c".
  331.  
  332.   whereis \turboc\ab*.c         search downward from the \turboc\ directory
  333.                                 on the default drive looking for "ab*.c".
  334.  
  335.   whereis d:*.dat -a            search entire drive d: and all ARC files
  336.                                 on drive d: looking for "*.dat".
  337.  
  338.   whereis cd:*.dat -a           search entire drive c: and drive d: and all
  339.                                 ARC files looking for "*.dat".
  340.  
  341.   whereis myprog                search entire default drive looking for
  342.                                 "myprog.*" (WhereIs will append a ".*" to
  343.                                 a filename with no extender specified).
  344.  
  345.  
  346.                                  WhereIs v4.4a                        Page 7
  347.  
  348.  
  349.                         Additional Command Line Switches                      
  350.  
  351.  
  352.  
  353.      Switch:  -A
  354.     Meaning:  search all ARC files
  355. Description:  The '-a' switch tells WhereIs to look in any ARC file
  356.               encountered for a matching filename.  If a matching filename
  357.               is found, it will be displayed in parenthesis along with the
  358.               full name of the ARC file it resides in.
  359.  
  360.  
  361.      Switch:  -AO
  362.     Meaning:  search -ONLY- ARC files
  363. Description:  The '-ao' switch tells WhereIs to ONLY look in any ARC file
  364.               encountered for a matching filename.  If a matching filename
  365.               is found, it will be displayed in parenthesis along with the
  366.               full name of the ARC file it resides in.
  367.  
  368.  
  369.      Switch:  -ARC -PAK -PKA -LZH -ZIP -ZOO
  370.     Meaning:  search only the ARC formats specified
  371. Description:  These switches tell WhereIs to only look inside the specified
  372.               ARC files for a matching filename.  For example, if you are
  373.               sure that the file named MYPROG.EXE is somewhere on drive C:
  374.               in a .ZIP file, then
  375.  
  376.                         whereis c:myprog.exe -zip
  377.  
  378.               would find the file.  Specifying individual ARC format switches
  379.               slightly speeds up WhereIs, because the program doesn't have to
  380.               waste time searching for (and through) all six ARC formats.
  381.  
  382.  
  383.      Switch:  "regular expression"
  384.     Meaning:  do a grep-type search on the filename
  385. Description:  Any command line string enclosed within double quotes will be
  386.               considered a regular expression, and will cause WhereIs to go
  387.               into its "grep mode".   A regular expression can be used with
  388.               or without a filename search mask.
  389.  
  390.               As of version 4.1a, when you specify a regular expression,
  391.               WhereIs will also look inside of 4DOS description files for
  392.               the string specified.  If a match is found, the normal output
  393.               line will be displayed, along with the actual 4DOS description
  394.               line below the filename line.
  395.  
  396.               Special characters within the quoted string are as follows:
  397.  
  398.  
  399.                       ^  -  start matching at the first of the filename
  400.                       ?  -  match any character in this position
  401.                     [..] -  range check on character at this position
  402.  
  403.               The easiest way to explain is with a few examples:
  404.  
  405.                                  WhereIs v4.4a                        Page 8
  406.  
  407.  
  408.                         Additional Command Line Switches                      
  409.  
  410.  
  411.  
  412.               whereis *.bat
  413.  
  414.                   the regular search; will display any .BAT file found.
  415.  
  416.  
  417.               whereis *.bat "42"
  418.  
  419.                   will display any .BAT file that contains the characters
  420.                   "42" anywhere in the filename.
  421.  
  422.  
  423.               whereis *.bat "^???42"
  424.  
  425.                   will display any .BAT file that contains the characters
  426.                   "42" in the fourth position of the filename.
  427.  
  428.  
  429.               whereis "[0-9]"
  430.  
  431.                   will display any file that contains a number anywhere in
  432.                   the filename.
  433.  
  434.  
  435.               whereis "[^0-9]"
  436.  
  437.                   will display any file that DOES NOT contain a number
  438.                   anywhere in the filename.
  439.  
  440.  
  441.               whereis "^???a?[acew-z]"
  442.  
  443.                   will display any file that contains an 'a' in the fourth
  444.                   position of the filename and the letters 'a', 'c', 'e',
  445.                   'w', 'x', 'y', or 'z' in the sixth position of the name.
  446.  
  447.  
  448.               These grep masks also work when looking inside of ARC files.
  449.  
  450.  
  451.       Switch:  -C"command to execute"
  452.                -O"command to display"
  453.      Meaning:  Execute (or display) a DOS command on all files found.
  454.  Description:  This switch tells WhereIs to execute the command within the
  455.                double quotes on each matching file found.  When doing this
  456.                command, you have access to replaceable parameters to get to
  457.                the full filename, the pathname only, the filename only, and
  458.                the name of the archive member (if you're searching archives).
  459.                The only difference between the -o and the -c switches is
  460.                that -c actually executes the command whereas -o prints the
  461.                command it WOULD have executed to the screen.  Because of
  462.                this, the -o command can be invaluable.  First, you can use
  463.  
  464.                                  WhereIs v4.4a                        Page 9
  465.  
  466.  
  467.                         Additional Command Line Switches                      
  468.  
  469.  
  470.                it before doing the -c command to make sure that what you
  471.                think you told WhereIs to do is the same as what you DID
  472.                tell it to do.  In other words, if you're about to do a
  473.                command that could have side effects (such as deleting files),
  474.                it would be good to do the -o command first and look at what
  475.                WhereIs actually will do when you execute the -c command.
  476.                The second use of the -o command is to redirect all of the
  477.                command lines into a batch file that you can execute later.
  478.                Replacement parameters for both -c and -o are as follows:
  479.  
  480.         Parm      Desc           Normal example      Archive example
  481.         ----      ----          -----------------   -----------------
  482.          &f   full file name    c:\dos\xcopy.exe    c:\dos\comlib.zip
  483.          &p   path name only    c:\dos\             c:\dos\
  484.          &d   directory name    c:\dos              c:\dos
  485.          &n   file name only    xcopy.exe           comlib.zip
  486.          &m   archive member    <blank>             xcopy.exe
  487.  
  488.                A few examples would probably be the best way to explain this
  489.                concept.  Let's do a few "real-world" examples here.
  490.  
  491.                1)  You have many .DOC files straying all over your hard drive,
  492.                    and you'd like to incorporate them all into one simple
  493.                    ZIP file.  You could do this with the following command:
  494.  
  495.                       C:> whereis -d *.doc -c"pkzip -m c:\docs.zip &f"
  496.  
  497.                2)  You want to make a copy of all of your Pascal source code
  498.                    that has been changed today so that you can take it home
  499.                    with you:
  500.  
  501.                       C:> whereis -d *.pas -s0 -c"copy &f a:\"
  502.  
  503.                3)  You want to get a text file listing of every directory
  504.                    name on your hard drive(s) in the file HARDRIVE.DAT:
  505.  
  506.                       C:> whereis -d nul -o"&p" >c:\Hardrive.Dat
  507.  
  508.                4)  You want to delete every .BAK file on your system (even
  509.                    those that are in ZIP files).  This would be a 2-step
  510.                    process:
  511.  
  512.                    First, delete the normal .BAK files
  513.  
  514.                       C:> whereis *.bak -v -n
  515.  
  516.                    Then, delete them from the archive files
  517.  
  518.                       C:> whereis -d -ao -zip *.bak -c"pkzip -d &f &m"
  519.  
  520.  
  521.      Switch:  -D
  522.  
  523.                                  WhereIs v4.4a                        Page 10
  524.  
  525.  
  526.                         Additional Command Line Switches                      
  527.  
  528.  
  529.     Meaning:  search all available hard drives.
  530. Description:  This switch tells WhereIs to search every hard drive on your
  531.               system (including network drives), starting with C:.  In other
  532.               words, if you have drives C:, D:, E:, and F: then the following
  533.               two command lines would do the exact same thing:
  534.  
  535.                         whereis cdef:myprog.exe
  536.                     or
  537.                         whereis myprog.exe -d
  538.  
  539.  
  540.      Switch:  -DIR
  541.     Meaning:  include directory names in the search.
  542. Description:  This switch tells WhereIs to also include directory names in
  543.               the search.  This allows you to not only locate a lost file,
  544.               but lost directories, too.
  545.  
  546.  
  547.       Switch: -DUP
  548.      Meaning: Display only duplicate filenames on the drives searched.
  549.  Description: If the -DUP switch is specified, only those files that have
  550.               duplicate entries will be displayed.  All other switches are
  551.               active during -DUPlicate processing.  For example, the
  552.               following command line:
  553.  
  554.                       whereis *.bat -a -d -dup
  555.  
  556.               would cause WhereIs to search all hard drives (-d) looking for
  557.               duplicate .BAT files.  WhereIs would also look inside of all
  558.               found Archive files (-a).
  559.  
  560.  
  561.      Switch:  -E
  562.     Meaning:  use "*.*" for subdirectory searches
  563. Description:  By default, WhereIs assumes that you don't have any directories
  564.               on your hard drive that have extensions in the filename.  So,
  565.               when WhereIs is looking for new directories, it will search with
  566.               a filemask of "*.".   This significantly speeds up the hard drive
  567.               search.  If you do have directories that have extensions in their
  568.               names, you must specify the '-e' switch or WhereIs -will not-
  569.               find files within that subdirectory.  The easiest thing to do is
  570.               to set your WhereIs environment variable to default to this
  571.               option (see "The WhereIs Environment Variable" below).
  572.  
  573.  
  574.      Switch:  -F
  575.     Meaning:  display filenames only
  576. Description:  This switch causes WhereIs to display only the filename of
  577.               matching files that it finds.  No header or footer information
  578.               will be displayed.  This is most useful when you are
  579.               redirecting the output from WhereIs to a file.
  580.  
  581.  
  582.                                  WhereIs v4.4a                        Page 11
  583.  
  584.  
  585.                         Additional Command Line Switches                      
  586.  
  587.  
  588.  
  589.      Switch:  -G or -GF
  590.     Meaning:  go to the drive and subdirectory of the found file
  591. Description:  If you specify the '-g' switch, WhereIs will prompt you with
  592.  
  593.                             Goto this subdirectory? _
  594.  
  595.               whenever it finds a matching file.  Press 'Y' to change to
  596.               the drive and subdirectory displayed, or 'N' to continue
  597.               searching the drive.  You may also enter 'Q' to abort WhereIs.
  598.               If you specify the '-gf' switch, WhereIs will change to the
  599.               directory of the first found file without prompting you.
  600.  
  601.  
  602.      Switch:  -H
  603.     Meaning:  start searching in the current subdirectory
  604. Description:  The '-h' switch tells WhereIs "start searching where I'm at
  605.               right now".   For example, if you are currently in the TURBOC
  606.               subdirectory, then the following two commands would do the
  607.               exact same thing:
  608.  
  609.                          whereis \turboc\myprog.c
  610.                      or
  611.                          whereis myprog.c -h
  612.  
  613.               With the '-h' switch, WhereIs can be used as a directory
  614.               program with the ability to list ARC files.  For example,
  615.               you could create the following batch file and call it
  616.               ARCDIR.BAT:
  617.  
  618.                             @echo off
  619.                             whereis %1 -h -a
  620.  
  621.               Now, when you give the command "ARCDIR", you will be shown
  622.               the directory listing, along with all files contained within
  623.               ARC files in your current subdirectory.
  624.  
  625.  
  626.      Switch:  -I
  627.     Meaning:  ignore the environment variable WhereIs
  628. Description:  The '-i' switch tells WhereIs to ignore any default switches
  629.               that you have set with the WhereIs environment variable.  This
  630.               is most useful if you have page-breaking set up as a default,
  631.               but need to redirect WhereIs's output to a file.  You could do
  632.               this with a command such as:
  633.  
  634.                            whereis *.bat -i >files.dat
  635.  
  636.  
  637.      Switch:  -M -R -PL
  638.     Meaning:  modify WhereIs's default output display
  639. Description:  These switches allow you to modify the way that WhereIs
  640.  
  641.                                  WhereIs v4.4a                        Page 12
  642.  
  643.  
  644.                         Additional Command Line Switches                      
  645.  
  646.  
  647.               displays its output.  By default, WhereIs will place the
  648.               filename on the left of the screen (just like DIR does).
  649.               If you prefer, you can use '-M' to place the filename in the
  650.               middle of the screen, '-R' to place the filename on the
  651.               right of the screen, or '-PL' to put the pathname on the left
  652.               of the screen.  Usually set in the environment.
  653.  
  654.  
  655.      Switch:  -K
  656.     Meaning:  search only the PATH directories
  657. Description:  This switch will cause WhereIs to only search in the directories
  658.               that are specified in your DOS PATH environment variable.
  659.               This option will be used very rarely, but was requested by a
  660.               user.
  661.        Note:  As of v4.1a, this switch was changed.  The '-K' switch was
  662.               previously the '-C' switch.
  663.  
  664.      Switch:  -Y
  665.     Meaning:  display the output with European-style dates (DD-MM-YY)
  666. Description:  Again, a seldom-used switch, but requested by a user.
  667.  
  668.  
  669.      Switch:  -V [-N]
  670.     Meaning:  do a verified delete of any matching files found
  671. Description:  These switches tell WhereIs to delete any matching files found.
  672.               If you specify only the '-V' switch, then WhereIs will prompt
  673.               you before it deletes each file.  If you specify BOTH the '-V'
  674.               and the '-N' switch, then WhereIs --WILL NOT-- prompt you; it
  675.               will just go ahead and delete the file (PLEASE be careful with
  676.               this one!).  I use these switches daily to clean up all of the
  677.               .BAK files created by Turbo C.  For example:
  678.  
  679.                           whereis *.bak -v -n
  680.  
  681.  
  682.      Switch:  -W
  683.     Meaning:  show wasted space occupied by matching files.
  684. Description:  This switch is used very little, but can come in handy if you
  685.               are trying to figure out how much disk space is being wasted
  686.               by a bunch of very small files (batch files are a prime
  687.               example).  WhereIs will total and display to you the amount of
  688.               disk space that is being wasted due to cluster overhead.
  689.  
  690.  
  691.      Switch:  -U
  692.     Meaning:  display all output in upper case
  693. Description:  Some people still prefer to see directory-type listings in
  694.               ALL UPPER CASE; if you're one of these people, then just use
  695.               the '-U' switch.  It's best to set this in your WhereIs
  696.               environment variable.
  697.  
  698.  
  699.  
  700.                                  WhereIs v4.4a                        Page 13
  701.  
  702.  
  703.                         Additional Command Line Switches                      
  704.  
  705.  
  706.      Switch:  -P
  707.     Meaning:  pause and wait for a key when the screen fills up
  708. Description:  A very handy switch, best used when set in your environment
  709.               variable.   It will cause WhereIs to pause the screen when it
  710.               fills up, so you don't have to go crazy trying to hit the
  711.               control-S key.
  712.  
  713.  
  714.      Switch:  -PKLite
  715.     Meaning:  search for files compressed with PKLite
  716. Description:  This switch will cause WhereIs to only look for .COM and
  717.               .EXE files that have been compressed with PK-Ware's PKLITE
  718.               program.  PKLite is a program that compresses executable
  719.               programs, and then un-compresses them at runtime.
  720.  
  721.  
  722.      Switch:  -Xfilemask
  723.     Meaning:  exclude this filespec from the search
  724. Description:  The '-X' switch allows you to exclude certain filenames from
  725.               the directory search.  You can specify up to 25 exclusion
  726.               masks.   For example, if you wanted to see all files on your
  727.               drive except for .OBJ and .PRG files, you could do:
  728.  
  729.                         whereis *.* -x*.obj -x*.prg
  730.  
  731.  
  732.      Switch:  -LT -EQ -GT
  733.     Meaning:  specify a file size range
  734. Description:  These switches allow you to only search for files within a
  735.               certain size range.  Some examples:
  736.  
  737.                          whereis *.PAS -LT1024
  738.  
  739.               would display all .PAS files that have a size smaller than
  740.               1024 bytes.
  741.  
  742.                          whereis *.* -EQ0
  743.  
  744.               would display all files that have a length of zero.
  745.  
  746.                          whereis *.* -GT500000
  747.  
  748.               would display all files that are larger than 500,000 bytes.
  749.  
  750.                          whereis *.* -GT1023 -LT2049
  751.  
  752.               would display all files that are between 1,024 and 2,048
  753.               bytes in size.
  754.  
  755.  
  756.      Switch:  -S -B
  757.     Meaning:  specify a file date range
  758.  
  759.                                  WhereIs v4.4a                        Page 14
  760.  
  761.  
  762.                         Additional Command Line Switches                      
  763.  
  764.  
  765. Description:  These switches allow you to only search for files within a
  766.               certain date range.  These switches are the "since" (S)
  767.               switch and the "before" (B) switch.  Both switches come in
  768.               two flavors; you can specify the date in number of days
  769.               (ie: -S5) or with a full date (ie: -S8-19-89).   If you
  770.               specify either switch with no date specifier, then it defaults
  771.               to '0 days'.  These date specifiers are also used when looking
  772.               inside of archive files.  Some examples:
  773.  
  774.                           whereis *.PAS -S5
  775.  
  776.               would display all .PAS files that have a date greater than or
  777.               equal to 5 days ago (in other words, modified SINCE 5 days ago).
  778.  
  779.                           whereis *.PAS -S5-1-89
  780.  
  781.               would display all .PAS files modified SINCE  5/1/89.
  782.  
  783.                           whereis *.PAS -B5
  784.  
  785.               would display all .PAS files modified BEFORE 5 days ago.
  786.  
  787.                           whereis *.PAS -B5-1-89
  788.  
  789.               would display all .PAS files modified BEFORE 5/1/89.
  790.  
  791.                           whereis *.PAS -S5-1-89 -B6-1-89
  792.  
  793.               would display all .PAS files modified between the dates of
  794.               5-1-89 and 5-31-89.
  795.  
  796.                           whereis *.PAS -S
  797.  
  798.               would display all .PAS files that have been modified today
  799.               (defaults to '-S0').
  800.  
  801.  
  802.      Switch:  -Z
  803.     Meaning:  show only files with their archive bit set
  804. Description:  The '-Z' switch allows you to display only those files which
  805.               have their "archive bit" set on.  In other words, it will show
  806.               all files that have been modified since your last backup (if
  807.               your backup program clears the archive bit, that is).
  808.  
  809.  
  810.      Switch:  -HIDDEN
  811.     Meaning:  also show hidden and system files
  812. Description:  The '-hidden' switch allows you to also display those files
  813.               which are "system" and "hidden" files.
  814.  
  815.                                  WhereIs v4.4a                        Page 15
  816.  
  817.  
  818.                 The WHEREIS and WI_DRIVES Environment Variables               
  819.  
  820.  
  821.  
  822.     When WhereIs begins execution, it searches the environment for a variable
  823. named WHEREIS.   If this variable is present, its contents will be appended
  824. onto the command line just as if you had entered them in from the keyboard.
  825. This option is very handy for setting "default options" that you'd like for
  826. WhereIs to perform every time.   Simply set the WHEREIS variable in your
  827. AUTOEXEC.BAT file.   For example, if you'd like to always (a) page break
  828. when the screen fills up, (b) display the filenames on the right of the
  829. screen, and (c) display output in upper case, you would put the following in
  830. your AUTOEXEC.BAT file:
  831.  
  832.                     SET WHEREIS=-P -R -U
  833.  
  834.  
  835.     WhereIs would then use these options every time you executed the program.
  836.  
  837.  
  838.    If you specify the "-d" switch (search all drives), then WhereIs will
  839.  search the environment looking for a variable named WI_DRIVES.   If this
  840.  variable is found, WhereIs will use this list as the definition of the
  841.  drives to search.  If the WI_DRIVES variable does not exist, WhereIs will
  842.  use its own list, which defaults to drives c: through z: (ie: cde...z).
  843.  
  844.    The WI_DRIVES variable was added mainly for those people using networks.
  845.  WhereIs's reckless abandon of simply searching all drive letters caused
  846.  some network users a lot of headaches.   It seems that those affected the
  847.  most were users of Novell networks.   On Novell, you can specify many
  848.  different drive letters for the same "volume" (ie: partition), so WhereIs
  849.  would show the same physical file many times, since WhereIs thought that
  850.  it was really on a different drive.   With the WI_DRIVES variable, it is
  851.  up to the user to tell WhereIs what drives are physically different.  For
  852.  example, let's assume that you have 3 volumes defined, and the drive letter
  853.  assignments are as follows:
  854.  
  855.                  Volume 1  -     drives C: and D:
  856.                  Volume 2  -     drives E: and F:
  857.                  Volume 3  -     drives G: and H:
  858.  
  859.    For WhereIs to work correctly, you would put the following line in your
  860.  AUTOEXEC.BAT file:
  861.  
  862.                     Set WI_DRIVES=CEG
  863.  
  864.    Now, when you search using the "-d" switch, WhereIs won't list duplicate
  865.  filenames.  I have never used a Novell network, so I'm hoping that this
  866.  change will eliminate the problems.   This problem was brought up to me in
  867.  a letter from Bud Huddleston of Chamblee, GA.   Luckily, he went into great
  868.  detail on what the problem was.  The WI_DRIVES variable was the easiest
  869.  way I could think of to attack this problem.   If this isn't the best way
  870.  to handle the situation, I'd appreciate it if you Novell users would drop
  871.  me a line with suggestions.  Note that the search for the WI_DRIVES variable
  872.  CAN NOT be over-ridden from the command line.  If the WI_DRIVES variable
  873.  
  874.                                  WhereIs v4.4a                        Page 16
  875.  
  876.  
  877.                 The WHEREIS and WI_DRIVES Environment Variables               
  878.  
  879.  
  880.  exists, it is used every time.  If you need to search a different list,
  881.  you must specify a drive list with the filename instead of using the "-d"
  882.  switch.  For example, "whereis cdfg:*.bat".
  883.  
  884.    For those users who are not on a network, you don't need to do anything
  885.  differently from version 3.5 of WhereIs.   If the WI_DRIVES variable isn't
  886.  defined, then v3.6 will perform exactly as v3.5 did.
  887.  
  888.  
  889.                                  WhereIs v4.4a                        Page 17
  890.  
  891.  
  892.                           Duplicate Filename Searching                        
  893.  
  894.  
  895.  
  896.     V4.0 of WhereIs incorporates a feature that I've been wanting for a very
  897.   long time - the ability to search all drives, including Archive files, and
  898.   display only those files that are duplicated somewhere else.   This was a
  899.   fairly major upgrade to do, but it turned out (in my opinion) to be the best
  900.   added feature to WhereIs yet.
  901.  
  902.     Maybe I'm worse than other people at this, but I'm terrible about doing a
  903.   download of a file, un-Arcing it, and then starting to use it.  Of course,
  904.   the original of that file is still sitting out there somewhere in an Archive
  905.   file just eating up hard disk space.
  906.  
  907.     With the new -DUP feature, cleaning up your multiple hard drives from any
  908.   duplicate files is much easier.  But, be aware that when you invoke the -DUP
  909.   switch, WhereIs gets VERY memory-hungry.  This is because WhereIs must keep
  910.   information on every filename on all of your hard drives (including all of
  911.   those filenames in any Archive files) in memory AT ONE TIME.
  912.  
  913.     If you ever get the message "Error: out of memory!" when trying to find
  914.   duplicates across all drives, there are a couple of things that you can do.
  915.   First of all, see if you can free up any more memory by removing any TSR's
  916.   or device drivers.  If you still get the "out of memory" message, then there
  917.   are two different things that you can do.   The first is that you could
  918.   compare the drives two (or three) at a time.  For example, if you
  919.   have drives C:, D:, E:, and F:, first compare drives C: and D:, then C: and
  920.   E:, etc. until you've scanned them all.
  921.  
  922.     The second thing you can do (the way I prefer) is to do the duplicate scan
  923.   with a filemask; in other words, do the scan on *.EXE, then *.COM, then
  924.   *.BAT, etc.   For example, here's a sample of what you'd do:
  925.  
  926.               C:> whereis *.com -d -a
  927.  
  928.               C:> whereis *.bat -d -a
  929.  
  930.               C:> whereis *.exe -d -a
  931.  
  932.     I don't see the "out of memory" being a problem except for those people
  933.   with HUGE hard drives.  I have two 40-meg drives, both packed full of ZIP
  934.   files, and I never got close to filling up memory.   In addition, WhereIs
  935.   is fairly intelligent when saving the names in memory; for example, if
  936.   you have 300 files in the path C:\TEST1\TEMP\DATA, the actual pathname
  937.   will only get saved one time.  If you are looking for duplicates on a very
  938.   big hard drive system (let's say 80 meg or more), then WhereIs will take some
  939.   time.   Don't be alarmed if the program seems to not be doing anything;
  940.   searching the file tables of very large hard drives takes some time.  I
  941.   tinkered with the idea of putting in a twirling cursor or something so that
  942.   you'd know WhereIs was still alive, but I decided against it.  Since
  943.   duplicate searching will probably be redirected to a printer or a disk file
  944.   most of the time, I didn't want to trash up the display.
  945.  
  946.  
  947.  
  948.                                  WhereIs v4.4a                        Page 18
  949.  
  950.  
  951.                           Duplicate Filename Searching                        
  952.  
  953.  
  954.     Don't forget that the -DUP switch works in tandem with ALL other WhereIs
  955.   switches.   For example, specifying -DUP doesn't automatically scan all hard
  956.   drives and look inside all Archive files.  You must still specify the -A and
  957.   -D switches.    Also, filename exclusions still work just like normal.
  958.   Let's do a few examples:
  959.  
  960.  
  961.       C:> whereis -d -a -dup
  962.  
  963.                    This is the command you'll normally want to do when
  964.                    searching for duplicates.  It causes WhereIs to search
  965.                    all hard drives, and inside Archive files, looking for
  966.                    duplicates.
  967.  
  968.  
  969.       C:> whereis *.bat -d -a -dup
  970.  
  971.                    This command would only list the duplicate .BAT files
  972.                    on your hard drives.
  973.  
  974.       C:> whereis cd:*.* -a -dup -x*.bak -x*.doc
  975.  
  976.                    This command would display all duplicate files on drives
  977.                    C: and D: except any .BAK or .DOC files.
  978.  
  979.                                  WhereIs v4.4a                        Page 19
  980.  
  981.  
  982.                             File Distribution Points                          
  983.  
  984.  
  985.  
  986.  
  987. Bulletin Board Numbers:
  988.  
  989.  
  990.   You can always find the latest versions of all of my PC utilities (such
  991. as WhereIs, LCD, DelDir, AdMenu, etc.) on the following BBS's:
  992.  
  993.  
  994.          Name               Location          Number
  995.    ------------------      ----------       ------------
  996.    Blue Ridge Express      East coast       804-790-1675  (21 lines)
  997.    Hard Disk Cafe          Midwest          618-684-3990  (file area "Z")
  998.    C & C                   Midwest          618-253-3608
  999.    ATT-PAC                 West coast       415-829-6062
  1000.  
  1001. End of document.
  1002.